Inside Macintosh: QuickDraw GX Objects /

Chapter 2 - Shape Objects / Shape Objects Reference

Functions / Creating and Manipulating Shape Objects

GXSetDefaultShape

You can use the GXSetDefaultShape function to replace the default shape object of a particular shape type.

void GXSetDefaultShape(gxShape target);

target

A reference to the new default shape object.

DESCRIPTION

The GXSetDefaultShape function replaces an existing default shape with the shape specified by the target parameter. The shape type of the target shape determines which default shape is replaced. This function disposes of the old default shape and increments the owner count of the target shape.

You can use the GXSetDefaultShape function to replace the style, ink, or transform of one of the default shapes by specifying a target shape with a different style, ink, or transform than the old default shape. When QuickDraw GX creates new shapes of the target shape's shape type, the new shape will have the same ink, style, and transform as the target shape.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
shape_is_nil
illegal_type_for_shape	(debugging version)

SEE ALSO

Default shape objects are discussed in the section "Default Shapes" beginning on page 2-18.

To create a copy of a default shape object, use the GXNewShape function, described in the next section.